home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / RANDO101.ZIP / RANDO.DOC < prev    next >
Encoding:
Text File  |  1994-05-19  |  20.2 KB  |  439 lines
  1.  
  2.     RANDO - RANDom Origin file maintenance             *   v1.02
  3.  
  4.     Written by: Don Dawson, 1:141/730 @FidoNet            March, 1992
  5.                                                   *Revised, May, 1994
  6.     This program is distributed under the Dinnerware concept.  You
  7.     might ask, what's Dinnerware?  You might know of Shareware and
  8.     Freeware.  The Dinnerware concept is this:  You don't owe me or
  9.     anyone else a thing if you choose to use this program.  However,
  10.     take your spouse, significant other, best friend or anyone
  11.     else you choose out to dinner.  You'll enjoy it, they'll enjoy it.
  12.  
  13.                              or
  14.     
  15.     Can't afford dinner?  Send a Thank You note/message to the person
  16.     that helped you set up your bbs or sent this program to you. It'll
  17.     only take a minute.
  18.  
  19.     THIS MATERIAL IS DISTRIBUTED "as is" WITHOUT ANY EXPRESSED OR
  20.     IMPLIED WARRANTY OR LIABILITY FOR DIRECT, (IN)DIRECT OR
  21.     (IN)CONSEQUENTIAL DAMAGES.  If it breaks, you own ALL the parts.
  22.     (see SOCIAL COMMENTARY below)
  23.  
  24.     OVERVIEW:
  25.  
  26.     Why RANDO?  Rando will create random ORIGIN files in each of your
  27.     echomail areas.  Some message editors (MSGED for sure) and some FidoNet
  28.     BBS software (OPUS 1.70 and Maximus) will use this file to create a
  29.     'custom' origin line instead of the same one in every echo.
  30.  
  31. *   I had fun writing this.  I've had fun using it.  It appears many other
  32.     folks are using it too.  I've received requests to modify RANDO to
  33.     process SQUISH.CFG because RANDO is (still) only capable of reading
  34.     an AREAS.BBS file.  Life goes on, there's never enough time to do all
  35.     the things any of us would like and I have never found the time to
  36.     add the ability to add a SQUISH.CFG option.  However, there's GOOD NEWS!
  37.  
  38. *   Jay Kendall, the fine sysop at 1:141/338 wrote a seperate program called:
  39.  
  40.     SQ2AREAS: a SQUISH.CFG to AREAS.BBS converter
  41.               Copyright (c) 1993, 1994 Jay S. Kendall
  42.               All rights reserved.
  43.     
  44. *   He's given me permission to package his fine utility with RANDO so that
  45.     everyone that's using just SQUISH.CFG can enjoy RANDO just as much as
  46.     those that still have an "old" AREAS.BBS file.  SQ2AREAS will make an
  47.     AREAS.BBS file that RANDO can use.  You say you have both a SQUISH.CFG
  48.     *and* an AREAS.BBS?  No problem.  Let RANDO use your regular AREAS.BBS
  49.     then use SQ2AREAS to make one from your SQUISH.CFG.  Just be careful
  50.     SQ2AREAS doesn't delete your "real" file by accident.
  51.  
  52. *   Here's what a *.BAT file might look in the worst case:
  53.  
  54. *   @echo off
  55.     <run RANDO (normally) here if you have an AREAS.BBS file>
  56.     <run SQ2AREAS to make an AREAS.BBS file from SQUISH.CFG>
  57.     <run RANDO, using the AREAS.BBS from the above step>
  58.     <delete the AREAS.BBS created by SQ2AREAS (see below)>
  59.     echo Rando is done!  Enjoy!
  60.  
  61. *   In case you wondered, there are still plenty of other fine utilities
  62.     around that use AREAS.BBS that were written by equally busy authors
  63.     that haven't/can't find the time to use SQUISH.CFG. Even if you don't
  64.     use RANDO, SQ2AREAS is worth everything you paid for this file. <grin>
  65.  
  66. *   See the epilogue at the end of this file.  Enjoy!
  67.  
  68. *   One last note: RANDO will still identify itself as 1.01.  Only the DOCS
  69.     have changed.
  70.  
  71.     SOCIAL COMMENTARY:
  72.     
  73.     Before going on, a word from your Sponsor. <g>
  74.         
  75.     The * Origin line *does* serve a purpose.  It's to identify the node #
  76.     from which an echomail message originated.  Most sysops use something
  77.     appropriate for their bbs.  Here's the one my BBS uses when an echomail
  78.     message originates from 1:141/730:
  79.  
  80.      * Origin: Treasure Island =HST/DS= 203-791-8532 (1:141/730)
  81.  
  82.     If you use RANDO, please use tasteful (humorous?) material.  I don't
  83.     recommend letting your BBS use the RANDO origin lines.  Why?  Although
  84.     your material may be appropriate, there's no telling if it's appropriate
  85.     for the context of the message that a caller writes.  I only use this
  86.     for messages that I write with my external message editor.  If the Origin
  87.     isn't appropriate for the message context, I can use the editor to change
  88.     it.  A BBS caller can't do this.  Besides, how many of them read 'em
  89.     anyway?
  90.     
  91.     Here's an example using an Origin from the enclosed file:
  92.     
  93.     A caller writes in an echomail message:
  94.     
  95.     I NEVER beat my wife!
  96.     
  97.     Your BBS adds this as an Origin:
  98.     
  99.     * Origin: To every exception there is a rule. (1:9999/9999)
  100.  
  101.     Get the idea? 
  102.     
  103.     Enjoy!    
  104.  
  105.     HOW IT WORKS:
  106.  
  107.     It will read a file (of up to 1400 lines) and randomly write an
  108.     ORIGIN (no extension) or <areaname>.sqo (for squish areas) file into
  109.     each echo area.  Passthru echo areas are skipped (those with a # anywhere
  110.     on the AREAS.BBS line).
  111.     
  112.     Note:  See below if you don't have an AREAS.BBS file.
  113.     
  114.     Of course, it reads the AREAS.BBS to find the path to each echomail
  115.     directory.  For creative and "what's an AREAS.BBS?" users please see
  116.     below.
  117.         
  118.     Because "high bit" characters (greater than ASCII 127) are frowned
  119.     upon in any Zone 1 echomail, if the input file contains any such
  120.     characters the characters will be replaced with a + or a -.  Any lines
  121.     longer than 44 characters will be skipped and will be written to an
  122.     'error file' so you can either delete them or edit them to make the
  123.     lines shorter.  Why 44 characters?  Origin lines must be a single
  124.     line.  Multiple lines are not appreciated.  Allowing for the beginning
  125.     *Origin stuff and the ending (1:xxx/yyy@fidonet.org) 44 should do it.
  126.  
  127.     USING RANDO:
  128.  
  129.     You must provide two command line parameters, optionally five more,
  130.     seperated by a space (UPPER, lower or MiXeD case are ok).  If you
  131.     run it without anything on the command line you'll get something
  132.     like this:
  133.  
  134.      ╒════════════════════════════════════════════════════════╕
  135.      │            RANDO v1.01 - Random Origin lines           │
  136.      │ (C) Copyright 1991/2 by Don Dawson 1:141/730.0@Fidonet │
  137.      ╘════════════════════════════════════════════════════════╛
  138.  
  139.  
  140. Usage: [-a\path\filename] [-q\path\filename] [-e\path\filename]
  141.         [-x\path\filename] [-l] [-b] [-s]
  142.  
  143.   -a [path and file name of AREAS.BBS]
  144.      ex:. -ac:\misc\areas.bbs
  145.   -q [path and file name of quotes file]
  146.      ex:  -qc:\misc\quotes.lst
  147.   -e [path and file name of quotes error file] (optional)
  148.      ex:  -ec:\misc\rando.err
  149.   -x [path and file name of areas to eXclude (optional)
  150.      ex:  -xc:\misc\skipem.lst
  151.   -b BBS name from the AREAS.BBS file will be prefixed to the origin line.
  152.      ex:  -b
  153.   -s Run silently.
  154.      ex:  -s
  155.   -l Write rando.log containing \yourpath\ and each origin line.
  156.      ex:  -l
  157.    
  158.         . -A  the name and path to your AREAS.BBS file (required).
  159.  
  160.         . -Q  the name and path to the file that contains the stuff
  161.               (famous quotes?) you want to use in your *Origin line.
  162.               (required)
  163.  
  164.         . -E  the name and path to a file into which you'd like all
  165.               "errors" in your quote file written. (optional)
  166.  
  167.         . -X  the name and path to a file containing areas you would
  168.               like eXcluded from processing.  It must be in 'areas.bbs'
  169.               file format.  As a matter of fact, you can make a copy
  170.               of your areas.bbs file and delete or comment out the areas
  171.               that you want included.  Everything left in the file will
  172.               be excluded. (optional)
  173.  
  174.         . -B  This will prefix the contents of the origin file with your
  175.               BBS name.  The BBS name is the same one that's in your
  176.               areas.bbs (probably on the first line).  Everything up to
  177.               the '!' will be included. WARNING: Your BBS name must be
  178.               less than 44 characters.  If your BBS name + a randomly
  179.               selected line from the origin file is greater than 44 
  180.               characters, only your BBS name will be used for that origin
  181.               file. (optional)
  182.               
  183.         .  -S This will avoid displaying the paths to the origin line files
  184.               as the program runs.  The program will run a little quicker if
  185.               you use this. (optional)
  186.  
  187.         . -L  Log into RANDO.LOG each path and origin file contents.
  188.               (optional)
  189.  
  190.     EXAMPLES:
  191.  
  192.     rando -ac:\bbs\areas.bbs -qc:\bbs\quotes.txt -s
  193.  
  194.             Note: No trailing backslash following the file name(s).
  195.  
  196.     rando -ac:\misc\myareas.bbs -qd:\stuff\myorigin.bbs -ec:\junk\errors.lst
  197.  
  198.             This will write 'input file errors' to the ERRORS.LST file.
  199.  
  200.     rando -ac:\bbs\areas.bbs -qc:\bbs\quotes.txt -b
  201.     
  202.             Your BBS name will be prefixed to the contents of each origin
  203.             line in each ORIGIN file.
  204.  
  205.     CREATIVE USERS or "What's an areas.bbs"?
  206.     
  207.     An areas.bbs file looks like this:
  208.     
  209. Treasure Island ! Don Dawson
  210. $f:\msg\141STUFF  141STUFF        141/740 701
  211. f:\msg\141SYSOP  141SYSOP        141/740 701
  212. f:\msg\4DOS      4DOS            141/740 701
  213. f:\msg\80XXX     80XXX           141/740 775
  214. f:\msg\ANEWS     ANEWS  #        141/565 740 123/45
  215. #f:\msg\ANIME    ANIME           141/740 701
  216.  
  217. The first line has: the BBS name, a 'space ! space', sysop name.
  218.  
  219. The following lines have \yourpath and the AREATAG.
  220.  
  221. The # indicates a 'passthru' area.
  222.  
  223. The $ indicates a 'squishmail' area. (Yes, you can mix and match sq/msg).
  224.  
  225. RANDO is really only interested in one thing, the path to the directory
  226. into which to write the ORIGIN file.  If an area is 'passthru' (#), an
  227. ORIGIN file will not be created in that directory. Everything else is
  228. ignored.
  229.  
  230. If you want to be creative, you can do this:
  231.  
  232. Make two or more "fake areas.bbs" files, name them anything you want. For
  233. example: you might have a collection of origin lines that you want to use
  234. only in your sysop echos, another set in other echoes.  Run RANDO once for
  235. each group.  Like this:
  236.  
  237. For the sysop echoes:
  238.  
  239. rando -ac:\files\sysop.bbs -qc:\files\sysop.qte -s
  240. rando -ac:\files\others.bbs -qc:\files\other.qte -s
  241.  
  242.     Kudos to the Beta Testers:
  243.     
  244.     My thanks to the fine folks that took the risk and tested RANDO:
  245.     
  246.     Rob Schmaling, 141/765
  247.     Steve Plain,   141/980
  248.     Gary Snider,   141/740
  249.     Noel Smith,    141/945
  250.     Rudy Ramsey,   141/755
  251.     Paul Brazil,   141/710
  252.     Furlan Primus, 141/590
  253. ------------------------------------------------------------------------------
  254.  
  255. Revision History:
  256.  
  257. Version .01  5/25/91, the original
  258.         .02  5/26/91, made the display different
  259.         .03  5/28/91, added -x and -b options
  260.         .04  never released
  261.         .05  7/31/91, improved command line processing and an origin line
  262.              will not be repeated as long as there are at least the same
  263.              number (or more) of origin lines as there are areas.
  264.         .06  7/31/91, removed test code (OOPS!).  More 'error checking'
  265.              improvements.
  266.         .07  8/3/91, updated the docs.  Thanks to Gary Snider for the
  267.              "creative users" idea.
  268.              .  Documentation update.
  269.              .  It will now process files that contain '-' in the file
  270.                 name or path.
  271.              .  The 'errorfil' is renamed to rando.err.
  272.              .  Improved reporting of non-existent paths in the AREAS.BBS
  273.                 file.
  274.         .08  8/7/91, minor fixes:
  275.              . The RANDO.ERR file will only be created when there are
  276.                 errors instead of with every execution.  (Thanks Furlan!)
  277.              . Fixed a minor mite that would result in writing an empty
  278.                ORIGIN file if there were fewer quote lines than when there
  279.                were areas to write to.
  280.         .09  8/8/91, minor enhancement (requested):
  281.              . added -l command line option
  282.              . minor documentation fixes
  283.         .091 8/12/91, 2 mites fixed
  284.              . if -b was selected some long origin lines were not detected.
  285.              . the "error.log" is erased each time.
  286.         .092 8/13/91, minor enhancements
  287.              .  The rando.log is erased each run.
  288.              .  The -s (silent) and -l (log) options are now independent
  289.                 of each other.
  290.              .  The -l option no longer lists to the screen.
  291.              .  Minor doc updates.
  292.         .093 11/22/91
  293.              .  Will now skip Squish areas.  It looks for a $ in the path
  294.                 to an echo area.  Like this:
  295.                 
  296.                 $f:\msg\AVIATION  AVIATION        141/740
  297.                 
  298.                 ORIGIN in not supported in Maximus 2.0 <sigh>
  299.  
  300.         1.00 12/26/91
  301.              .  Well....no bug reports from anyone and none noted here.  Time
  302.                 to make the plunge with a version 1.00!
  303.              .  Good news!  ORIGIN *is* supported in Maximus 2.0.  It's an
  304.                 un-documented feature.  RANdO will now create an ?.sqo for
  305.                 each squish area.  I don't know how to get Maximus itself
  306.                 to use ?.sqo, but stand alone message editors should.
  307.              .  For each line in AREAS.BBS that begins with a $, the ?.sqo
  308.                 will be created.  For example, this area:
  309.                 
  310.                 $f:\om\AVIATION  AVIATION        141/740
  311.  
  312.                 will have an AVIATION.SQO file created in the same directory
  313.                 as all of the other AVIATION.SQ? files.
  314.  
  315.               . Minor DOC update.
  316.         1.01  3/8/92
  317.               . The 'randomness' is improved.  Some kind soul uploaded a neat
  318.                 randomizing algorithm to my BBS.  It's much better.
  319.               . The # of lines in the ORIGIN.LST file increased from 1000 to
  320.                 1400.  This is for all of you running around the echoes with
  321.                 your origin line butterfly net and adding them to your file.
  322.               . The number of areas that can be eXcluded is lowered from 1000
  323.                 to 200.  That should be enough, no?
  324.               . If a path to a message area can't be found or there's no
  325.                 corresponding squish<areaname>.* files, the program will
  326.                 complain by beeping but it will continue to run.
  327.               . There's only been one bug reported since RANDO was first
  328.                 released.  The sysop and I exchanged several netmail messages
  329.                 trying to diagose it.  His areas.bbs file had some 'strange
  330.                 stuff' in it.  He fixed it, problem went away.
  331.         1.02  5/19/94
  332.               . Ok, I'm LAZY!  Jay Kendall [Hi Jay!] gave me permission to
  333.                 package his fine utility with RANDO so I could re-release
  334.                 RANDO for all the fine sysops that only use a SQUISH.CFG.
  335.                 Thank goodness fine folks like Scott Dudley, Jay Kendall and
  336.                 others are still out there developing fine toys for all of
  337.                 us that enjoy this fine hobby.  My hat is off to them!
  338.                 Thanks guys.
  339.  
  340. Epilogue:
  341.  
  342. As a newbee sysop some years ago, I was (and still am) amazed at how FidoNet
  343. works.  There were around 8,000 sysops in the nodelist, there are now about
  344. 30,000.  There are thousands of points and scores of thousands of QWK mail
  345. users on FidoNet and OtherNet BBS' around the globe.  My first BBS ran OPUS
  346. version 0.0 and little did I know at the time that it was taking FidoNet by
  347. storm.  Die hard Fido users were dumping Fido V11.something (I think)
  348. faster than you can say supercalifragilisticexpalidocious.  The aledged
  349. Information Highway has (almost) nothing on FidoNet.
  350.  
  351. It was about this time that someone said "Hey, if we can pass all these files
  352. around that contain echomail, why can't we pass around the files that everyone
  353. uses to run their BBS?".  Out of this simple question SDS was born. SDS, in
  354. case you wondered is Software Distribution System.  So...a bunch of people,
  355. quick to rally around a wonderful idea, said YES, YES, YES!  I had the good
  356. fortune to be the original Region 16 SDS co-ordinator.  Once the
  357. "organization" was in place we all sent netmail to each other and said, "Ok,
  358. now what?  How are we going to distribute this stuff". <laughing>  
  359.  
  360. Ron Bemis, always the opportunist, quickly wrote FLEA.  As soon as he used
  361. us all to get out the major bugs, he put in an annoying feature to encourage
  362. everyone to register FLEA.  I sent Ron my $10 (maybe $20) and received netmail
  363. telling me how I could call Dallas, Texas and download my registered version
  364. of his fine utility.  Of course, I called.  Getting in to his BBS with all
  365. the "cute" security he had in place (I'm not a terrific typist) was worse
  366. (I imagine) then trying to break into Fort Knox.  Each time I screwed up
  367. and mis-typed something his BBS would hang up.  After the 3rd failed attempt
  368. I simply gave up and sent him CRASH NETMAIL (there was no LPM then) and told
  369. him where he could put his registered version of FLEA.  Wherever it was, I
  370. don't think you'll find sunshine.
  371.  
  372. Anyway...somehow Barry Geller volunteered to write TICK (Get it? FLEA - TICK).
  373. Barry is one of the (many) unsung heroes of FidoNet.  He's very talented
  374. and always a gentleman.  Thank you , for the millionth time, Barry!  Thank
  375. you too to George Peace for his wonderful companion RAID program.
  376.  
  377. So...SDS was off and running.  Every day at least one new toy arrived
  378. on Treasure Island, often several.  These wonderful files then went to many
  379. other systems in Region 16 (New England). File echoes were born.  The fine
  380. creative and programming talents of hundreds of sysops (and non-sysops) were
  381. readily available around the world.  Another FidoNet communication wonder!
  382. I forget some of the details, but the Dallas phone system was crippled
  383. the day Wynn Wagner released his much sought after new OPUS version. So many
  384. calls were coming into Dallas from sysops around the world file requesting
  385. the new OPUS version that it shutdown phone communications in Dallas.  Wynn
  386. wisely decided to use SDS and actually released his next OPUS version a few
  387. days early to prevent a reoccurance.
  388.  
  389. Anyway, SDS flourished for several years.  For reasons I can only guess,
  390. it is no longer a credible distribution method for wonderful new BBS toys.
  391. Although I've tried, as a former SDS RC, to get the attention of the current
  392. SDS folks it (my efforts and SDS) has failed miserably. I see that Mark
  393. Woolworth has "adopted" BBS file distribution into UTILNET2.  In part,
  394. UTILNET2 will now distribute:
  395.  
  396. Areas UTL-GATE 0     !      DOS BBS Mail Gating Utilities
  397. Areas UTL-MAIL 0     !      DOS BBS Mailers
  398. Areas UTL-MSG  0     !      DOS BBS Message Handling Utilities
  399. Areas UTL-NLST 0     !      DOS BBS Nodelist Compilers and Utilities
  400. Areas UTL-PNT  0     !      DOS BBS Point Utilities
  401. Areas UTL-PROG 0     !      DOS BBS Programs
  402. Areas UTL-READ 0     !      DOS Sysop/Point Mail Readers
  403. Areas UTL-TIC  0     !      DOS BBS File Handling Utilities
  404. Areas UTL-OBBS 0     !      DOS BBS Other Utilities
  405.  
  406. So...if you're reading this, chances are it arrived on your BBS via UTILNET2.
  407. Some may receive it via SDS, but not many, it seems.
  408.  
  409. This is the last file I attempt to distribute via SDS.  Hello UTILNET2!
  410.  
  411. Thanks Mark!
  412.  
  413. Thanks to Tom Hendricks and to all the current SDS folks too!:
  414.  
  415. Region 10 SDS Coordinator:  Diane Farrell Smith, 1:161/7
  416. Region 11 SDS Coordinator:  Terry Fields, 1:231/40
  417. Region 12 SDS Coordinator:  Ken Wilson, 1:163/211
  418. Region 13 SDS Coordinator:  Barry Geller, 1:266/12
  419. Region 14 SDS Coordinator:  John Rickey, 1:280/2
  420. Region 15 SDS Coordinator:  Jim Hansel, 1:260/400
  421. Region 16 SDS Coordinator:  Gordon Green, 1:132/119
  422. Region 17 SDS Coordinator:  Frank Cox, 1:140/53
  423. Region 18 SDS Coordinator:  *** Open ***
  424. Region 19 SDS Coordinator:  Bob Juge, 1:106/2000
  425.  
  426. Overall SDS Coordinator:    Tom Hendricks, 1:261/662
  427.  
  428. and to those that made it work so well for so long.  Thanks too to all
  429. the program authors and doc writers that used SDS.  I hope you embrace
  430. UTILNET2 with the same passion that you once embraced SDS.  Waking up in
  431. the morning to find another new toy that automagically arrived on the BBS
  432. beats reading thousands of echomail messages to find there's something new
  433. and then having to file request it, probably long distance.  Gawd, isn't
  434. Planet Connect wonderful?
  435.  
  436. Don Dawson
  437. 1:141/730@fidonet.org
  438. May, 1994
  439.